Manager: File Manager

While Carbon will support most of the File Manager interface, there are a number of significant changes.

You should not access File Manager structures directly if accessor functions for the structure exist. For example, you should call PBGetFCBInfo rather than calling LMGetFCBSPtr and walking the FCB table.

Similarly, you should create file system specification (FSSpec) records using the functions PBMakeFSSpec or FSMakeFSSpec instead of filling in your own structures. File system specification records must contain a volume reference number, a parent directory, and a name. Substituting a working directory for the volume reference number or a full or partial pathname for the name is not supported.

File Manager functions that support MFS (the Macintosh file system) will not be supported in Carbon. These include

* functions, such as OpenWD and GetWDInfo, that manipulate working directories

* functions that identify a file or folder using a volume reference number and pathname but not a parent directory ID. You should use the HFS version of these calls (which use a parent directory ID) instead.

Functions that cannot be called by PowerPC applications (such as PBGetAltAccessSync and PBGetAltAccessAsync) will not be supported.

In general, you should use only documented File Manager interfaces in your application. For example, you should use a documented API call to get low memory information rather than access undocumented low memory global variables or vectors directly.

The default volume format for Carbon will be the Mac OS Extended format; in most cases you will not need to modify your application to gain this volume support.

Carbon may not support the File System Manager (FSM) as defined in the header file FSM.h. FSM plug-ins today often must make assumptions about File Manager data structures that may not be valid in Carbon. In addition, some plug-ins use 68K calling conventions when calling internal File Manager functions. Since the File System Manager was designed for a single-threaded file system, it cannot use the full threading capabilities of Mac OS X.

 Allocate

 AllocContig

 CatMove

 CloseWD

Working directories not supported. Use file system specification (FSSpec) records instead.

 Create

 create

 DirCreate

 Eject

 eject

Use Eject instead.

 FInitQueue

 FlushVol

 flushvol

Use FlushVol instead.

 FSClose

 FSDelete

 fsdelete

 FSMakeFSSpec

 FSOpen

 fsopen

 FSpCatMove

 FSpCreate

 FSpDelete

 FSpDirCreate

 FSpExchangeFiles

 FSpGetFInfo

 FSpOpenDF

 FSpOpenRF

 FSpRename

 FSpRstFLock

 FSpSetFInfo

 FSpSetFLock

 FSRead

 fsrename

 FSWrite

 GetEOF

 GetFInfo

 getfinfo

 GetFPos

 GetFSInfo

 GetFSQHdr

 GetVCBQHdr

 GetVInfo

 getvinfo

 GetVol

Working directories are not supported.

 getvol

Working directories are not supported.

 GetVRefNum

 GetWDInfo

Working directories not supported. Use file system specification (FSSpec) records instead.

 HCreate

 HDelete

 HGetFInfo

 HGetVol

 HOpen

 HOpenDF

 HOpenRF

 HRename

 HRstFLock

 HSetFInfo

 HSetFLock

 HSetVol

 InformFFS

 InformFSM

 InstallFS

 OpenDF

 OpenRF

 openrf

 OpenWD

Working directories not supported. Use file system specification (FSSpec) records instead.

 PBAllocateAsync

 PBAllocateSync

 PBAllocContigAsync

 PBAllocContigSync

 PBCatMoveAsync

 PBCatMoveSync

 PBCatSearchAsync

 PBCatSearchSync

 PBCloseWDAsync

Working directories not supported. Use file system specification (FSSpec) records instead.

 PBCloseWDSync

Working directories not supported. Use file system specification (FSSpec) records instead.

 PBCreateAsync

Obsolete. Use PBHCreateAsync instead.

 PBCreateFileIDRefAsync

 PBCreateFileIDRefSync

 PBCreateSync

Obsolete. Use PBHCreateSync instead.

 PBDeleteAsync

Obsolete. Use PBHDeleteAsync instead.

 PBDeleteFileIDRefAsync

 PBDeleteFileIDRefSync

 PBDeleteSync

Obsolete. Use PBHDeleteSync instead.

 PBDirCreateAsync

 PBDirCreateSync

 PBDTAddAPPLAsync

 PBDTAddAPPLSync

 PBDTAddIconAsync

 PBDTAddIconSync

 PBDTCloseDown

 PBDTDeleteAsync

 PBDTDeleteSync

 PBDTFlushAsync

 PBDTFlushSync

 PBDTGetAPPLAsync

 PBDTGetAPPLSync

 PBDTGetCommentAsync

 PBDTGetCommentSync

 PBDTGetIconAsync

 PBDTGetIconInfoAsync

 PBDTGetIconInfoSync

 PBDTGetIconSync

 PBDTGetInfoAsync

 PBDTGetInfoSync

 PBDTGetPath

 PBDTOpenInform

 PBDTRemoveAPPLAsync

 PBDTRemoveAPPLSync

 PBDTRemoveCommentAsync

 PBDTRemoveCommentSync

 PBDTResetAsync

 PBDTResetSync

 PBDTSetCommentAsync

 PBDTSetCommentSync

 PBEject

 PBExchangeFilesAsync

 PBExchangeFilesSync

 PBFlushFileAsync

 PBFlushFileSync

 PBFlushVolAsync

 PBFlushVolSync

 PBGetCatInfoAsync

 PBGetCatInfoSync

 PBGetEOFAsync

 PBGetEOFSync

 PBGetFCBInfoAsync

 PBGetFCBInfoSync

 PBGetFInfoAsync

Obsolete. Use PBHGetFInfoAsync instead.

 PBGetFInfoSync

Obsolete. Use PBHGetFInfoSync instead.

 PBGetForeignPrivsAsync

 PBGetForeignPrivsSync

 PBGetFPosAsync

 PBGetFPosSync

 PBGetUGEntryAsync

 PBGetUGEntrySync

 PBGetVInfoAsync

Obsolete. Use PBHGetVInfoAsync instead.

 PBGetVInfoSync

Obsolete. Use PBHGetVInfoSync instead.

 PBGetVolAsync

Obsolete. Use PBHGetVolAsync instead.

 PBGetVolMountInfo

 PBGetVolMountInfoSize

 PBGetVolSync

Obsolete. Use PBHGetVolSync instead.

 PBGetWDInfoAsync

Working directories not supported. Use file system specification (FSSpec) records instead.

 PBGetWDInfoSync

Working directories not supported. Use file system specification (FSSpec) records instead.

 PBGetXCatInfoAsync

 PBGetXCatInfoSync

 PBHCopyFileAsync

 PBHCopyFileSync

 PBHCreateAsync

 PBHCreateSync

 PBHDeleteAsync

 PBHDeleteSync

 PBHGetDirAccessAsync

 PBHGetDirAccessSync

 PBHGetFInfoAsync

 PBHGetFInfoSync

 PBHGetLogInInfoAsync

 PBHGetLogInInfoSync

 PBHGetVInfoAsync

 PBHGetVInfoSync

 PBHGetVolAsync

 PBHGetVolParmsAsync

 PBHGetVolParmsSync

 PBHGetVolSync

 PBHMapIDAsync

 PBHMapIDSync

 PBHMapNameAsync

 PBHMapNameSync

 PBHMoveRenameAsync

 PBHMoveRenameSync

 PBHOpenAsync

 PBHOpenDenyAsync

 PBHOpenDenySync

 PBHOpenDFAsync

 PBHOpenDFSync

 PBHOpenRFAsync

 PBHOpenRFDenyAsync

 PBHOpenRFDenySync

 PBHOpenRFSync

 PBHOpenSync

 PBHRenameAsync

 PBHRenameSync

 PBHRstFLockAsync

 PBHRstFLockSync

 PBHSetDirAccessAsync

 PBHSetDirAccessSync

 PBHSetFInfoAsync

 PBHSetFInfoSync

 PBHSetFLockAsync

 PBHSetFLockSync

 PBHSetVolAsync

 PBHSetVolSync

 PBLockRangeAsync

 PBLockRangeSync

 PBMakeFSSpecAsync

 PBMakeFSSpecSync

 PBMountVol

 PBOffLine

 PBOpenDFAsync

Obsolete. Use PBHOpenDFAsync instead.

 PBOpenDFSync

Obsolete. Use PBHOpenDFSync instead.

 PBOpenRFAsync

Obsolete. Use PBHOpenRFAsync instead.

 PBOpenRFSync

Obsolete. Use PBHOpenRFSync instead.

 PBOpenWDAsync

Working directories not supported. Use file system specification (FSSpec) records instead.

 PBOpenWDSync

Working directories not supported. Use file system specification (FSSpec) records instead.

 PBRenameAsync

Obsolete. Use PBHRenameAsync instead.

 PBRenameSync

Obsolete. Use PBHRenameSync instead.

 PBResolveFileIDRefAsync

 PBResolveFileIDRefSync

 PBRstFLockAsync

Obsolete. Use PBHRstFLock Async instead.

 PBRstFLockSync

Obsolete. Use PBHRstFlockSync instead.

 PBSetCatInfoAsync

 PBSetCatInfoSync

 PBSetEOFAsync

 PBSetEOFSync

 PBSetFInfoAsync

Obsolete. Use PBHSetFInfoAsync instead.

 PBSetFInfoSync

Obsolete. Use PBHSetFInfoSync instead.

 PBSetFLockAsync

Obsolete. Use PBHSetFLockAsync instead.

 PBSetFLockSync

Obsolete. Use PBHSetFLockSync instead.

 PBSetForeignPrivsAsync

 PBSetForeignPrivsSync

 PBSetFPosAsync

 PBSetFPosSync

 PBSetFVersAsync

Obsolete. Use PBHSetFVersAsync instead.

 PBSetFVersSync

Obsolete. Use PBHSetFVersSync instead.

 PBSetVInfoAsync

 PBSetVInfoSync

 PBSetVolAsync

Obsolete. Use PBHSetVolAsync instead.

 PBSetVolSync

Obsolete. Use PBHSetVolSync instead.

 PBShareAsync

 PBShareSync

 PBUnlockRangeAsync

 PBUnlockRangeSync

 PBUnmountVol

 PBUnmountVolImmed

 PBUnshareAsync

 PBUnshareSync

 PBVolumeMount

 PBXGetVolInfoAsync

 PBXGetVolInfoSync

 RemoveFS

 rename

 Rename

 RstFLock

 rstflock

 SetEOF

 SetFInfo

 setfinfo

 SetFLock

 setflock

 SetFPos

 SetFSInfo

 SetVol

Working directories are not supported.

 setvol

Working directories are not supported.

 UnmountVol

 unmountvol

Use UnmountVol instead.

 UTAddNewVCB

 UTAdjustEOF

 UTAllocateFCB

 UTAllocateVCB

 UTAllocateWDCB

 UTBlockInFQHashP

 UTCacheReadIP

 UTCacheWriteIP

 UTCheckDirBusy

 UTCheckFileModifiable

 UTCheckFileRefNum

 UTCheckPermission

 UTCheckVolModifiable

 UTCheckVolOffline

 UTCheckVolRefNum

 UTCheckWDRefNum

 UTDetermineVol

 UTDisposeVCB

 UTEjectVol

 UTFindDrive

 UTFlushCache

 UTGetBlock

 UTGetDefaultVol

 UTGetPathComponentName

 UTIndexFCB

 UTLocateFCB

 UTLocateNextFCB

 UTLocateNextVCB

 UTLocateVCBByName

 UTLocateVCBByRefNum

 UTMarkDirty

 UTParsePathname

 UTReleaseBlock

 UTReleaseFCB

 UTReleaseWDCB

 UTResolveFCB

 UTResolveWDCB

 UTSetDefaultVol

 UTTrashBlocks

 UTTrashFileBlocks

 UTTrashVolBlocks

 UTVolCacheReadIP

 UTVolCacheWriteIP